home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3s / wcstod.z / wcstod
Encoding:
Text File  |  1998-10-20  |  3.5 KB  |  67 lines
  1.  
  2.  
  3.  
  4. wwwwccccssssttttoooodddd((((3333SSSS))))                                                          wwwwccccssssttttoooodddd((((3333SSSS))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _wwww_cccc_ssss_tttt_oooo_dddd - convert wide-character string to double-precision number
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_wwww_cccc_hhhh_aaaa_rrrr_...._hhhh_>>>>
  13.  
  14.      _dddd_oooo_uuuu_bbbb_llll_eeee _wwww_cccc_ssss_tttt_oooo_dddd _((((_cccc_oooo_nnnn_ssss_tttt _wwww_cccc_hhhh_aaaa_rrrr______tttt _****_nnnn_pppp_tttt_rrrr_,,,, _wwww_cccc_hhhh_aaaa_rrrr______tttt _****_****_eeee_nnnn_dddd_pppp_tttt_rrrr_))))_;;;;
  15.  
  16. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  17.      _wwww_cccc_ssss_tttt_oooo_dddd returns as a double-precision floating-point number the value
  18.      represented by the wide-character string pointed to by _n_p_t_r.  This
  19.      function scans the string up to the first unrecognized character.
  20.  
  21.      _wwww_cccc_ssss_tttt_oooo_dddd recognizes an optional string of ``white-space'' characters [as
  22.      defined by _iiii_ssss_wwww_ssss_pppp_aaaa_cccc_eeee in _wwww_cccc_tttt_yyyy_pppp_eeee(3S)], then an optional sign, then a string
  23.      of digits optionally containing a decimal-point character [as specified
  24.      by the current locale; see _ssss_eeee_tttt_llll_oooo_cccc_aaaa_llll_eeee(3C)], then an optional exponent part
  25.      including an _eeee or _EEEE followed by an optional sign, followed by an integer.
  26.  
  27.      If the value of _e_n_d_p_t_r is not _((((_wwww_cccc_hhhh_aaaa_rrrr______tttt _****_****_))))_NNNN_UUUU_LLLL_LLLL, a pointer to the
  28.      character terminating the scan is returned in the location pointed to by
  29.      _e_n_d_p_t_r.  If no number can be formed, *_e_n_d_p_t_r is set to _n_p_t_r, and zero is
  30.      returned.
  31.  
  32. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  33.      _wwww_cccc_tttt_yyyy_pppp_eeee(3S),
  34.  
  35. NNNNOOOOTTTTEEEE
  36.      Precision may be silently lost if the number of digits comprising the
  37.      floating-point number (i.e., not including the exponent) exceeds the
  38.      value of the constant DBL_DIG (LDBL_DIG) in _<<<<_ffff_llll_oooo_aaaa_tttt_...._hhhh_>>>>.
  39.  
  40. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  41.      If the correct value would cause overflow, _++++_////_----_HHHH_UUUU_GGGG_EEEE______VVVV_AAAA_LLLL is returned
  42.      (according to the sign of the value), and _eeee_rrrr_rrrr_nnnn_oooo is set to _EEEE_RRRR_AAAA_NNNN_GGGG_EEEE.
  43.  
  44.      If the correct value would cause underflow, zero is returned and _eeee_rrrr_rrrr_nnnn_oooo is
  45.      set to _EEEE_RRRR_AAAA_NNNN_GGGG_EEEE.
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.